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Introduction 


This supplement describes the general-purpose tools provided by 
Digital Research... to help driver and application developers write, 
compile, and maintain programs. The following tools are provided: 


Tool Description Page 
BANNER Prints banner pages 3 
CAT Concatenates files S 
CMP Compares two files 6 
CUT Cuts out specified fields from each line in a file 8 
DIFF Finds differences between two files 10 
DUMP Displays file contents in hexadecimal, octal, 12 
decimal, or signed decimal form. 
DUP Prints multiple lines of the same string 14 
ECHO Outputs special characters 15 
FGREP Searches a file or files for string entered 16 
GREP Searches a file or files for the pattern entered 17 
LC2UC Translates lowercase characters to uppercase 20 
MAKE Builds programs 21 
PASTE Merges lines from a file or files 26 
PR Prints a file or files 29 
SPLIT Breaks down a file into equal size files 33 
STRINGS Prints all sequences of printable characters in a file 34 
SUM Calculates file checksum and block count 35 
UC2LC Translates uppercase characters to lowercase 36 
WC Counts file lines, words, and characters 37 


Introduction Programming Tools 


In the descriptions that follow, options are shown in square brackets. 
Generally, you separate options and arguments in the command line 
with a space. The character | represents “or” and means you can enter 
either of the arguments shown. Utilities with the -? option have online 
information available. 


Generic Error Messages 


The following error messages are generic to most utilities: 
Unrecognized option -x 


This means you have entered an illegal option for that program; x 
indicates the illegal option. 


Cannot open xxxx 


This means the program cannot open one of the files specified; xxxx 
indicates the file that cannot be opened. 


The error messages unique to each tool are presented in the tool 
description. | | 
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BANNER 


Form BANNER [-w] string 


Explanation Use BANNER to print a title page or pages. Specify the 
banner contents on the command line as a string. The 
maximum string length on 80-column paper is 32 
characters; the maximum on 132-column is 52 
characters. BANNER accepts uppercase and lowercase 
characters, spaces, and printable special characters. 


BANNER prints the string characters in cells 16 lines 
high by 8 columns wide. Each character is separated by 
2 columns. The cells are centered vertically on the 
page. On 80-column paper, BANNER prints 8 characters 
per page. On 132-column paper, BANNER prints 13 
characters per page. 


The default BANNER paper size is 80 columns wide. Use 
the -w option to output to paper 132 columns wide. 


Examples In the following examples, & represents a space. 
banner SORTER#BVersb1.41/862:15 


This command prints three 80-column banner pages 
with the string divided as follows: 


Page 1: SORTER 
Page 2: Vers 1.4 
Page 3: 1/8 2:15 


BANNER Programming Tools 


banner -w SORTERBSourceBETABReleasebVersion 1.4 


This command prints three 132-column banner pages 
with the string divided as follows: 


Page 1: SORTER Source 
Page 2: BETA Release 
Page 3: Version 1.4 


Programming Tools CAT 


CAT 


Form 


Explanation 


Examples 


CAT [-s] [-] [filespec] [filespec] ... 


Use CAT to concatenate files. Separate each file 
specification with a space. The files are output in the 
order specified to the standard output device. No 
characters are inserted between the files in the output. 


Use the - argument to specify the standard input 
device as the input file. CAT also assumes the standard 
input device if you do not enter any file specifications. 


Use the -s argument to suppress error display if a file 
specified is not present. 


Note: Remember to specify a new name for the 
destination file when you concatenate files into a single 
file. When you use one of the input files as the 
destination, for example 


cat filel file2 > filel 


you destroy the original contents of file1. 


cat srcl src2 


Assuming the standard output device is the console, 
this command displays the files srcl and src2 on the 
screen. 


cat srcl src2 src3 src 4 > dest 


This command reads the files srcl, src2, src3, and src4 
and concatenates them in that order in the file dest. 
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CMP 


Form 


Explanation 
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CMP [-1] | [-s] filespec1 filespec2 


Use CMP to compare binary files. Enter a - in place of 
the first file specification to compare input from the | 
Standard input device with a file 


Default CMP output shows the location of each 
difference by line number and byte offset from the 
beginning of the file. Nothing its displayed if the files 
match. If the two files match up to a point, CMP 
indicates that one file is a subset of the other rather 
than listing each subsequent line as a difference. 


Enter the -l argument to print the conflicting bytes 
after the line location and offset. Enter -s to Suppress 
the display and generate one of the following exit 
codes: 


0 Files are identical 
1 Files have differences 
2 Command syntax error 


See the BATCH IF command description in the FlexOS 
User's Guide for the description of your options with 
respect to the exit code. 
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Examples 


Errors 


cmp -— filex 


This command takes input from the standard input 
device and compares it with the contents of the file 
filex. Where there are differences. CMP displays the 
location's line number and byte offset from _ the 
beginning of the file. If there are no differences, nothing 
is displayed. 


cmp -s file file2 


This command compares the contents of filel and file2. 
lf there are differences, the exit code 1 is returned. If 
there are no. differences, exit code O is returned. 
Otherwise, there is no program output. 


eof reached in xxxx 


The file xxxx is a subset of the other file specified. 
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CUT 


Form 


Explanation 
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CUT -cllist] [filespec] 
CUT -flist [-dchar] [-s] [filespec] 


Use CUT to strip characters on each file line according 
to column or character specifications. You designate 
the characters to save by their number or field. If you 
do not specify a file, CUT uses the standard input 


device. 


The options are defined as follows. You must enter 
either the -clist or —flist option. 


—clist 


Save characters by column. Enter the columns 
by number or, using a dash between numbers, 
by range. Separate each column selection with 
a comma. The following examples demonstrate 
column specifications: 


@® -c1-35,72 saves the  characters_ in 


columns 1 through 35 and 72. 


@® -c-25,35- saves the characters in 


columns 1 through 25 and 35 to the end 
of line. 


® -c89,.11,12 saves the characters’ in 


columns 8, 9, 11, and 12. 


Enter -c alone, without a list, to save the 
characters in columns 1 through 72. 
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Errors 


-flist Save characters by field number. Specify the 
fields by their number in the line. For example, 
the command -f1,3-5 saves the first and third 
through fifth field in each line. By default, CUT 
uses the tab character as the field delimiter. 
To specify a different delimiter, use the -d 
option. Lines with no delimiters are saved 
intact unless you enter the —s option. 


-d Specify field delimiter. Enter the character to 
use as. the field delimiter immediately 
following the option. Space characters and 
Characters with special meaning to the shell 
must be enclosed in quotes. 


=S Strip lines with no delimiter (-f option only). 
Normally, lines without a delimiter are saved. 
Use this command to strip them from the 
Output. 


Bad list for c/f option 


The -c or -f list specification contains one or more 
invalid characters. 


Line too long 

A line in the input file is too long for CUT. 

No fields 

The -f option specification does not include a field list. 
No delimiters 


The -d option specification does not specify a 
character. 


DIFF 


DIFF 


Explanation 
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DIFF [-bb|-b] filespec1 filespec2 
DIFF [-?] 


Use DIFF to compare two ASCII files. DIFF output 
indicates how to make the files match. 


Each difference is called out as either an addition, 
deletion, or replacement in the form: 


(filespec1 line numbers) type (filespec2 line numbers) 


where type is the character a (for addition), d (for 
deletion), or c (for change/replace). The following 
examples illustrate the three types of output. 


n3 a n5,n6 Add filespec2 lines 5 and 6 after 
filespec1 line 3. 

nin2dn3 Delete filespecl lines 1 and 2. 

nin2cn3,n4 Replace filespecl lines 1 and 2 with 
filespec2 lines 3 and 4. 


After each callout, the lines from each file are listed. 
Lines preceded with < are from filespect; lines 
preceded with > are from filespec2. 


The -bb and -b tell DIFF how to handle tabs and 
spaces. Enter -bb to have blanks and tabs ignored. 
Enter -b to have strings of blanks and tabs treated as 
equivalents and trailing blanks ignored. 
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Errors 


The DIFF exit code indicates whether or not differences 
were found as follows: 


0 No differences found 
1 Differences found 
2 Command error 


Out of buffer space 


Too many differences were found. 
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DUMP 


Form 


Explanation 
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DUMP [radix] [display] [+[bloffset,offset] [filespec] 
DUMP [-?] 


Use DUMP to display file contents. You control the 
radix and the display format with the following options: 


Radix Display 

-o octal -b bytes(default) 
-d decimal -w 16-bit words 
-S signed decimal -| 32-bit words 
-x hexadecimal (default) -c characters 


-m mixed -b and -c 


Radix and display options are mutually exclusive. 


Enter - instead of a file specification to read from the 
Standard input device. 


Use the + option to specify a starting and ending offset. 
Add the -b option to specify the offset in blocks (one 
block equals 1024 bytes). DIFF interprets the offset 
entries as byte values when —-b is not entered. Specify 
the offset with a leading zero to indicate an octal value 
Or terminate the offset with a period to indicate a 
decimal value. Otherwise, DIFF interprets the offset as a 
hexadecimal value. 
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Examples 


dump -w 23,0xcO xxxx 


This command displays the contents of file xxxx from 
locations 23H to OCOH as hexadecimal, word values. 


dump -o -b - 


This command reads the standard input device and 
displays the input as octal values in byte form. 
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DUP 


Form 


Explanation 


Example 


Errors 
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DUP count [-num] string 


Use DUP to print a string multiple times. The arguments 
are defined as follows: 


count The number of lines of string to print 

-num The number of times within a line to print the 
string 

string The characters to print 


DUP interprets count and num as decimal values. The 
default num is 1. Strings can contain C language 
conversion specifications in which the arguments set 
the number of strings per line and the string contents. 


In the following example, 6 represents a space. 
dup 4 -4 "“Bbbb%03db%3x" > chart 


This command writes a decimal-to-hex conversion 
chart 4 lines long with 4 entries per line in the file 
CHART. Each entry begins with 4 blank spaces. The 
chart appears as follows: 


000 0 001 J 002 2 003 3 
004 4 005 e, 006 6 007 7 
008 8 009 2 010 A O1i B 
012 C 013 D 014 E Q15 3 


Must specify count 


The duplication count was omitted. 
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ECHO 
Form ECHO [-n] [-q] arguments 


Explanation Use ECHO to write the following characters to the 
| Standard output device: 


\a 

\b 

\c 

\f 

\n 

\r 

\s 

\t 

\v 

‘ 
\--- 
\X-- 


bell 

backspace 

print line without new line 

form feed 

new line (carriage return and line feed) 
Carriage return 

space 

tab 

vertical tab 

backslash 

octal ASCII character code (1 to 3 digits) 
hexadecimal ASCII character code 


ECHO also accepts C-like escape conventions. Separate 
each character in the argument with a space. The 
arguments are terminated when a new line its received. 
ECHO automatically includes the new line in the output. 


The ECHO options are defined as follows: 


-~q Suppress output — 


“—n 


Suppress the automatic new line 
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FGREP 


Form 


Explanation 
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FGREP [-n] string [filespec] [filespec] ... 


Use FGREP to search a file or files for a string. Leave 
out the file specification or enter - to have FGREP 
search the standard input device. Use quotes to include 
Spaces in the string. 


FGREP prints each line in which the string appears. 
When more than one file is specified, FGREP precedes 
the line with the file name. 


Use the -n option to print the string’s line number, 
relative to the beginning of the file, at the beginning of 
each line. 


The FGREP exit code indicates whether or not matches 
were found as follows: 


0 Matches found 
1 No matches found 
2 Command error 
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GREP 


Form 


Explanation 


GREP [options] [expression] [filespec] [filespec] ... 


Use GREP to search a file or files for an expression. 
Where GREP finds a match, it prints the whole line and, 
when more than one file is specified, it precedes the 
line with the file name. 


You define the expression with the _ following 
characters: 


= Beginning of line 
$ End of line 
Any single character 


[xyz] Character specification: GREP searches on 
characters listed (here, x, y, or z is a match). 


[a-z] Character range specification: GREP searches 
on all characters in the range (here, lowercase 
characters between a and z are a match). 


[*xyz] “Other-than” character specification: GREP 
searches on. all characters besides those 
listed. 


: Closure: End of a part of the expression (use 
* as a wildcard) 


\s Space 

\t Tab 

\b Backspace 

\n New line (carriage return and line feed) 
\r Carriage return 
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The following options are available: 


—C 


—-e'exp’ 


-f'file’ 


Print only the count of matching lines 


Search on the following expression (use when 
the expression starts with a —). Do not include 
quotes. 


Search on the pattern in file. Do not include 
quotes. 


Do not distinguish between uppercase and 
lowercase Characters 


Print only the file names of files with 
matching lines 


Precede each line with the line number. 
Suppress “cannot open file” error message 


Print only lines that do not have a matching 
expression 


Separate options with a space. 


The GREP exit code indicates whether or not the 
command conditions were met as follows: 


0 
1 
2 


Matches found 
No matches found 
Command error 
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Example 


Errors 


GREP 


grep -i -n *..“[a-z0-9]*\t yyy 


This command searches the file yyy for an expression 
with the following characteristics: 


@ starts at the beginning line 
® begins with any two characters 
@® has a letter or number after the two _ initial 


characters 
@ has a tab after the letter or number 


Because the -i option is specified, the letter can be 
either uppercase or lowercase. The number of each line 
with the match precedes the line in the output. 


Cannot open expression file 


Could not open the file in -f specification. 
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LC2UC 


Form LC2UC [file] 


Explanation Use LC2UC to translate all characters in lowercase to 
uppercase. Leave out the file specification to use the 
Standard input device for input. 
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MAKE 


Form 


Explanation 


MAKE [-f makefile] [-i] [-n] [-s] [names] 


Use MAKE to build programs according to dependencies 
based on file time-date stamps. MAKE takes its 
instructions from two files: MAKE.INI| and MAKEFILE. 
MAKE.INI is optional and, if present, is always read first. 
MAKE searches the current path (see the PATH 
description) for the MAKE.INI file. MAKEFILE, however, 
must be in the current directory on the current or 
designated disk. 


MAKE command line options are defined as follows: 


=f tells MAKE that the following argument is the 
name of a makefile to be used instead of the 
default (MAKEFILE). 


=i tells MAKE to continue even if an error is 
encountered while executing a command. 


-n tells MAKE not to execute the commands, but 
write the ones that should be executed to the 
standard output. This is useful for creating 
batch files, for example. 


-S tells MAKE not to echo commands. Only text 
echoed from an invoked program appears on 
the screen. 


names File name or names of the dependencies to 
test in MAKEFILE. If no names are entered, 
MAKE tests all of the dependencies. 


MAKE.INI and MAKEFILE (or its equivalent) are built from 
three types of entries: commands, comments, symbol 
definitions, and dependencies. 
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A command line starts with a tab or space and 
consists of the command name followed by its 
arguments. When commands are encountered, MAKE 
uses the current PATH and ORDER definitions to find 
the command in the same manner as the shell. 


Commands are used in conjunction with the 
dependency lines to create conditional build 
instructions tin the MAKE.INI and MAKEFILE files. You can 
enter more than one command after a _ preceding 


-— dependency line. 


Command lines can have any combination of the 
following characters to the left of the command: 


@ MAKE does not echo the command line. 


MAKE ignores the exit code of the command, 
ie. the ERRORLEVEL. Without this, MAKE 
terminates when a nonzero exit code is 
returned. 


+ MAKE uses the shell to execute the command. 
You must use this if the command is a shell 
built-in command, a batch file, or if you use 
I/O redirection with < or > or|. 


A symbol definition has the form 


SYMBOL = value 


MAKE replaces all occurances of SYMBOL that follow 
the definition with the value defined. For example, if the 
following line is entered: 


FOO = foo.c, foo.h, foo.inp 


Make replaces the symbol reference $FOO or $(FOO) in 
all command and dependency lines with foo.c, foo.h, 
foo.inp. 
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To indicate a single “$” character, precede it with 
another “$”. For example, the MAKEFILE command line 


echo SStest 
is executed as 
echo Stest 


Any line starting with a # character is a comment line 
and is ignored by MAKE. MAKE also ignores blank lines. 


A dependency line has the form 
target : dependent 


Both the target and dependent values can be composed 
of one or more files; separate multiple entries with a 
space or tab. The dependent value is optional; if none 
is specified, the command that follows is always 
executed. Special allowance is made for the colons 
used in drive specifications. For example, the following 
line works as intended. 


€2£00.00).  aetoo.c 


The command or commands immediately following the 
dependency are executed only if the time-date stamp 
of the dependent is more recent than the target. 


If any of the target files does not exist, MAKE creates 
the dependent files. MAKE processes dependencies so 
that the lowest order files are processed first--MAKE is 
recursive in this sense. To ensure proper processing 
order, put the higher order dependencies first in the 
file. The following dependencies illustrate proper high- 
to-low order sequencing. 


foo.286 : f00.0b] 

(link command) 
FOO.00)] % £005 

(compile command) 
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After the dependent file or files have been processed, 
MAKE makes the target-dependency date comparison. 
As above, if any of the dependent are more recent than 
the target, the next command line is executed. 


There is a special sort of dependency line that allows 
for wildcards in the file names; it has the form: 


eo) & Fee 
he 2% 


This command tells MAKE: whenever a file of the form 
“obj needs to be made (for example, foo.obj), then, 
provided foo.c exists, MAKE creates foo.obj using the 
command: 


hc foo 


As above, MAKE makes the files on the dependent side 
first if they too need to be made. 


The special symbol $* is defined to be the name of the 
target file without its extension. It is valid only while 
MAKE is processing a wildcard dependency. 


The backslash character “\" also has special meaning; 
MAKE ignores the backslash and the end-of-line 
characters (carriage return and line feed) following it so 
that long lines can be constructed conveniently in the 
MAKEFILE. The example illustrates use of the backslash. 


Example 

The following MAKE.IN| and MAKEFILE files create a 
version of MicroEMACS from a set of C files using the 
Lattice.. C compiler. For brevity sake, the XOBJ group 
does not include all MicroEMACS object modules. 
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MAKE .INI # This is the default MAKEFILE for Lattice 


# "D“ model programs (D means small code. large data) 
LCIFLAGS = -iNIc\ -md -s -dLATTICE 


LC2FLAGS = -v 


# Note: -v causes the code generator to omit stack 
# overflow checking. 


* obj : *.c 
lol $* $(LCIFLAGS) 
lc2 $* $(LC2FLAGS) 


* obj : *.asm 
masm $*,$* nul ,nul 


MAKEFILE # Important directories 


MLIB 
HOME 


\mliob\d 
\xemacs 


# Objects generated from files in the HOME directory 


XOBJ = basic.obj \ 
buffer.obj \ 
cinfo.obj \ 
display.obj \ 
echo.obj \ 
extend.obj \ 
file.obj \ 
kbd.obj \ 
line.obj \ 
main.obj \ 
fileio.obj \ 
spawn.obj \. 
ttyio.obj \ i 
tty.oboj \ 
ttykbd.obj 


# Objects from the MLIB library 


MOBY = SMLIB\bcopy.obj S$MLIB\dosio.obj 
SMLIB\keyboard.obj \SMI.IB\video.obj 

OB = $(XOBUJ) S$(MOBJ) 

# Link it 


xemacs.exe : $(O0BJ) xemacs.inp 


# All C objects depend on three header files. But it’s 
# a nuisance recompiling everything for tiny changes. 
# This recompiles only when a few terminal-dependent 

# things in ttdef.h change. 


display.obj tty.obj ttyio.obj ttykbdd.obj : ttydef.h 


PASTE 


PASTE 


Forms 


Explanation 
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PASTE [-dlist] filespec1 filespec2 ... 
PASTE [-s] [-dlist] filespec 


Use PASTE to concatenate files on a line by line basis 
or to concatenate succeeding lines of one file. Enter a - 
instead of a file specification to use the standard input 
device as input. 


The default PASTE concatenation option merges the 
files in columnar fashion into a single file. For example, 
if the file alpha was composed of the following lines 


aaa 
bbb 
ccc 


and the file numbs was composed of the following lines | 


111 
222 
333 


the command 


paste apha numbs 


would produce the following output file: 


aaa lll 
bbb 222 
ccc 333 


Unless you specify otherwise, PASTE separates the 
lines from each file with a tab and puts a new line 
character at the end of each line. 
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Use the -dlist option to specify the character used to 
separate lines. The following escape sequences are 
available: 


\n New line (carriage return and line feed) 
\t tab 

\\ backslash 

\O nothing (no separation) 


PASTE uses the characters one at a time and returns to 
the first character in the list after using the last. For 
example, the command 


paste -—d\\\n.0 numbs alpha 


merges the alpha and numbs files shown above as 
follows: 


11l\aaa 
222 

bbb 
333CCE 


PASTE cycles through the -dlist entries, returning to 
the first separater after using the last. For example, if 
the files alpha and numbs had another line, PASTE 
would use the backslash to separate the two lines. 


Use the -s option to merge all lines in a file into one 
line. For example, the command 
paste -s alpha 


merges the lines in the alpha file shown above as 
follows: 


aaa bbb Ccce 


PASTE inserts a tab between lines unless you specify 
otherwise. Use the -dlist option as described above to 
select different line separaters. PASTE always puts a 
new line character after the last line merged. 
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dlist too long 

There were too many characters specified in —dlist. 
Bad dlist 

The —dlist entry contains an invalid entry. 

Too many files specified max is n 


There are too many files specified in the command line; 
n indicates the maximum. 


Too many files open max is n 


There are too many files specified in the command line 
than can be opened simultaneously; n indicates the 
maximum. 


Line too long 


An output line is too long. 
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PR 


Form 


Explanation 


PR [options] [filespec] [filespec] ... 


Use PR to print files. Leave out file specifications or 
enter - to use the standard input device as input. PR 
withholds error messages until all files are printed 
when you specify the terminal as the standard output 
device. 


PR default characteristics are as follows: 


@ Output is printed 66 lines per page with a 5-line 
header and 5 blank lines at the bottom of the page. 

@ Page header contains the page number, date and 
time, and file name. 

@® Columns are equal width, separated by a space. 

@® Lines are truncated at 72 character columns 


PR provides the following options. You can _ enter 
multiple options in a_single command. See_ the 
examples for the option input syntax. 


+k Start printing from page k. 


=k Print file contents in k columns per page (see 
examples for explanation) 


—ak Print file lines k per output line (See examples 
for explanation) 


-m Merge files one per column (as in PASTE 
above). PR ignores -k and -a arguments when 
you use —-m. 


-d Insert a blank line between lines (doublespace) 
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-eck 


—-nck 


—-wk 


—-Ok 


= 
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Set tabs to column positions. Replace c with 
the output tab character to be used (tab is the 
default). Replace k with the number of 
character positions per tab column (eight is 
the default). 


Print the file with k-digit line numbers (default 
number of digits is five). PR prints the number 
in the first tab column of each output column 
(where -k iS more than one) or each line 
(where -k is one or -m is selected). Replace c 
with the output tab character to be used (tab 
is the default). 


Truncate lines to k characters. 


Offset each line by k characters. The offset is 
considered a part of the total line length. 


Print pages k lines long (default is 66). 
Print the next argument in the page header. 


Pause at the end of each page when output 
device is a terminal. You enter a Carriage 
return to proceed with the next page. 


Output a form feed at the end of each page 
(default is a sequence of line feeds). In 
addition, -f forces PR to pause _ before 
Outputting the first page when the standard 
output device is a terminal. 


Omit error message from output when PR 
cannot open a file. | , 


Omit page header and 5 blank lines at the 
bottom of the page and stop output at the 
end of the file. (Otherwise, PR provides blank 
lines to the end of the final page.) 


Programming Tools PR 


—SC Do not truncate lines and separate columns 
with the character c. The -s default character 
is a tab. Valid entries for c are any characters 
and escape sequences \\ (backslash) and \0 (no 
column separation). 


Examples In the following examples, the file xxx consists of the 
following lines: 


PR -3 xxx 


This command prints the file xxx three columns per 
_page. The line sequence reads down each column. That 
is, the lines are printed as follows: 


1l 44 v1 
22 55 88 
33 66 99 
PR -a3 xxx 


This command also prints xxx three columns per page, 
however, the line sequence is printed across the page. 
That is, the lines are printed as follows: 


ia 22 33 
44 95 66 
T) 88 > be, 
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PR 


Errors 
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Programming Tools 


You can specify options in one of two ways. Enter a 
single - followed by the option letters. For example, the 
following command = prints xxx double-spaced, 3 
columns per page, a backslash between columns, and 
SOURCES added to the page header. 


PR -3dhs SOURCES xxx 


Alternatively, enter options individually, separated by a 
space. The following example prints xxx without page 
breaks and headers, with tab columns set at every 
fourth character position. and lines truncated at 48 
characters. | 


PR -t -e4 -w48 xxx 


Too many open files max is n 


Too many files are specified in the command line than 
can be open simultaneously; nis the maximum. 


Too many stdin files max is n 


Too many standard input files are specified in the 
command line; n is the maximum. 


Too many columns max is n 


The -k specification is too high; n is the maximum. 


Programming Tools SPLIT 


SPLIT 


Form SPLIT -n [filespec] Lnhewname] 


Explanation Use SPLIT to break down a file into equal length files. 
Specify the length of the new files in the -n argument 
where n indicates the number of lines. Leave out the 
file specification or enter - to specify the standard 
input device. 


The file name for the new files has two components: 
the newname entered and.a suffix with the characters 
aa through zz. The newname specification cannot be 
longer than 6 characters. The name of the first file 
Output is newname appended with aa, the second is 
newname appended with ab, and so forth to zy and 
finally zz. If no newname is entered, SPLIT uses x. 


Errors Exceed the maximum of 676 files 


The -n specification results in more than 676 new files. 
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STRINGS Programming Tools 


STRINGS 


Form STRINGS [-o] [-sn] filespec [filespec] ... 


Explanation Use STRINGS to print all printable characters in a file. 
The strings are output one string per line. Enter -o to 
Output the string’s file offset along with the string. 
Enter -s and a number to offset the output from 
column 1 by n character positions. STRINGS interprets 
the number as a hexadecimal value. 
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Programming Tools SUM 


SUM 


Form 


Explanation 


Errors 


SUM [-r] filespec 


Use SUM to generate a file checksum and block count. 
The block count indicates the number of 1024-byte 
blocks in the file. SUM generates the checksum using 
one of two internal algorithms. To use the alternate 
algorithm, enter the -r option. 


_ Read error on xxxx 


SUM encountered a file system error while reading the 
input file. 
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UC2LC Programming Tools 
UC2LC 
Form UC2LC filespec 


Explanation Use LC2UC to translate all characters in uppercase to 
lowercase. Leave out the file specification to use the 
Standard input device for input. 
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Programming Tools WC 


we 


Form 


Explanation 


WC [-clwx] filespec [filespec] .. 


Use WC to get the count of characters, lines, and/or 
words in a file or files. Leave out the file specification 
to use the standard input device for input. When you 
enter multiple files, WC outputs the total for each file 
separately and the total lines of all files. 


The WC default adds characters, lines, and words. (A 
word is defined as any Character string terminated by a 
Space, tab, or new line.) To select one or two file 
characteristics, enter the abbreviation. For example, the 
following command adds only the characters and lines 
in file xxx. | 


WC —-Cl XXX 


WC prints the total for each characteristic as a decimal 
value. Use the -x option to print the sum as a 
hexadecimal value. 


End of Supplement 
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